home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / hpr2.z / hpr2
Encoding:
Text File  |  2002-10-03  |  4.2 KB  |  100 lines
  1. HPR2(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      CCHHPPRR22, ZZHHPPRR22 - Performs Hermitian rank 2 update of a packed complex
  6.      Hermitian matrix
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Complex
  10.  
  11.         CCAALLLL CCHHPPRR22 ((_u_p_l_o,, _n,, _a_l_p_h_a,, _x,, _i_n_c_x,, _y,, _i_n_c_y,, _a_p))
  12.  
  13.      Double complex
  14.  
  15.         CCAALLLL ZZHHPPRR22 ((_u_p_l_o,, _n,, _a_l_p_h_a,, _x,, _i_n_c_x,, _y,, _i_n_c_y,, _a_p))
  16.  
  17. IIMMPPLLEEMMEENNTTAATTIIOONN
  18.      IRIX systems
  19.  
  20. DDEESSCCRRIIPPTTIIOONN
  21.      These routines perform the following Hermitian rank 2 operation:
  22.                         _H                                   _H
  23.           _A  <- _a_l_p_h_a _x_y  + (complex conjugate of _a_l_p_h_a)* _y_x  + _A
  24.                                                               _H      _H
  25.      where _a_l_p_h_a is a scalar, _x and _y are _n-element vectors, _x  and _y
  26.      conjugate transposes of _x and _y, respectively, and _A is an _n-by-_n
  27.      packed complex Hermitian matrix.
  28.  
  29.      These routines have the following arguments:
  30.  
  31.      _u_p_l_o      Character*1.  (input)
  32.                Specifies whether the upper or lower triangular part of
  33.                matrix _A is packed into the array argument _a_p, as follows:
  34.  
  35.                _u_p_l_o= 'U' or 'u': the upper triangular part of _A is being
  36.                supplied in the argument _a_p.
  37.                _u_p_l_o= 'L' or 'l': the lower triangular part of _A is being
  38.                supplied in the argument _a_p.
  39.  
  40.      _n         Integer.  (input)
  41.                Specifies the order of matrix _A.  _n >= 0.
  42.  
  43.      _a_l_p_h_a     Scalar alpha.  (input).
  44.                CCHHPPRR22: Complex.
  45.                ZZHHPPRR22: Double complex.
  46.  
  47.      _x         Array of dimension 1+(_n-1) * |_i_n_c_x|.  (input)
  48.                CCHHPPRR22: Complex array.
  49.                ZZHHPPRR22: Double complex array.
  50.                Contains vector _x.
  51.  
  52.      _i_n_c_x      Integer.  (input)
  53.                Increment for the elements of _x.  _i_n_c_x must not be 0.
  54.  
  55.      _y         Array of dimension 1+(_n-1) * |_i_n_c_y|.  (input)
  56.                CCHHPPRR22: Complex array.
  57.                ZZHHPPRR22: Double complex array.
  58.                Contains vector _y.
  59.  
  60.      _i_n_c_y      Integer.  (input)
  61.                Increment for the elements of _y.  Argument _i_n_c_y must not be
  62.                0.
  63.  
  64.      _a_p        Array of dimension (_n(_n+1))/2 .  (input and output)
  65.                CCHHPPRR22: Complex array.
  66.                ZZHHPPRR22: Double complex array.
  67.  
  68.                Before entry with _u_p_l_o = 'U' or 'u', array _a_p must contain
  69.                the upper triangular part of the Hermitian matrix packed
  70.                sequentially, column-by-column, so that _a_p(1) contains
  71.                _A(1,1), _a_p(2) contains _A(1,2), _a_p(3) contains _A(2,2), and so
  72.                on.  On exit, the upper triangular part of the updated
  73.                matrix overwrites array _a_p.
  74.  
  75.                Before entry with _u_p_l_o = 'L' or 'l', array _a_p must contain
  76.                the lower triangular part of the Hermitian matrix packed
  77.                sequentially, column-by-column, so that _a_p(1) contains
  78.                _A(1,1), _a_p(2) contains _A(2,1), _a_p(3) contains _A(3,1), and so
  79.                on.  On exit, the lower triangular part of the updated
  80.                matrix overwrites array _a_p.
  81.  
  82.                The imaginary parts of the diagonal elements need not be
  83.                set.  They are assumed to be 0; on exit, they are set to 0.
  84.  
  85. NNOOTTEESS
  86.      CCHHPPRR22/ZZHHPPRR22 is a Level 2 Basic Linear Algebra Subprogram (Level 2
  87.      BLAS).
  88.  
  89.      When working backward (_i_n_c_x < 0 or _i_n_c_y < 0), this routine starts at
  90.      the end of the vector and moves backward, as follows:
  91.  
  92.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)) , ..., _x(1)
  93.  
  94.           _y(1-_i_n_c_y * (_n-1)), _y(1-_i_n_c_y * (_n-2)) , ..., _y(1)
  95.  
  96. SSEEEE AALLSSOO
  97.      SSPPRR(3F)
  98.  
  99.      This man page is available only online.
  100.